The HTML Output Wizard demonstrates how a Visual FoxPro user builds a wizard. The finished Wizard takes data from a table or view and generates an HTML document. The user may select a sort method for the table. The final output is an HTML table. The sample wizard will follow the structure of the Form Wizard.
The sample wizard consists of three pages.
Page 1 contains a field mover, where the user selects a table or view, and from the table or view, selects fields.
Page 2 contains a sort mover, where the user may select up to three fields by which to sort the results.
Page 3 is the Finish screen. It contains a field for the form title, and the following radio buttons:
1. Save web page
2. Save web page and open it in browser
3. Save web page and modify it in editor
When the user clicks Finish, the user is prompted for a filename in which to store the generated HTML code. The ProcessOutput function calls the appropriate functions to generate HTML output (as a table) for each record, using the selected sort order.
Step text and description text is similar to the text in the Form Wizard. We can use the same BMPs as the Form Wizard uses.
Steps to construct wizard:
1. Create a folder to hold your project.
2. Create a new project
Engine code
3. Open the file WIZSTUB.PRG (located in the WZCOMMON folder), and save as HTMSTART.PRG in your project's folder. Add the file to your wizard's project. This file should be set as your projects MAIN file (under the Project menu).
4. Add the following program files (also located in the WZCOMMON folder): WZENGINE.PRG
5. Create a text file called HTMLWIZ.H in your project's folder. Add the file to your project. This file may be excluded from the final build. For each step in the wizard, add #DEFINEs for :
1. a title -- this appears in the step popup
2. a description - this appears on the wizard page, and describes what the user needs to do at that step.
3. the name of the bitmap file that appears on the page
6. Create a new program file called HTMLWIZ.PRG. This file will contain your "engine" code to handle the any special initialization, extra functions, and the final processing of the wizard. It contains a subclass of the WZENGINE class (located in the WZENGINE.PRG file). The Wizard will call your engine's PROCESSOUTPUT function. For the HTML Output Wizard, we need to add code to this function to generate our output.
The options the user has selected in the Wizard will be stored in various engine properties for use by this function. We will return to this
8. Modify HTMSTART program, and insert the name of your visual class (in this case, HTMLWIZ.VCX).
UI changes
9. Add the following visual class files (located in the WZCOMMON folder): WIZARD.VCX, WIZCTRL.VCX to the project.
10. Create a new VCX file called HTMLWIZ.VCX in your project's folder. Add the file to your project.
12. Modify the visual class HTML.VCX. Set the INCLUDE file to HTMLWIZ.H.
13. Add code to the INITSTEPS method with one line for each page (except the Finish page):
THIS.AddStep()
14. Add the FieldMover control to page 1. Add the SortMover control to page 2. [do whatever customization is necessary to get these controls to work.
15. Modify VCX to use new wzengine.
[Add code to FINISH method -- prep work, verification, get output file]
[Add code to PROCESSOUTPUT --> move Wizard UI values to arrays and vars that engine can access]
[Modify INIT2 -- to hold aPageRef s]
[Modify INITSTEPS --> specify steps in your wizard]
[Modify REFRESHSTEPS --> enable/disable pages as necessary]
[Modify TABLEREFRESH --> update other pages based on selections in FieldMover]
Set CEngineClassName vcx property to name of your engine class (e.g., "HTMLEngine").
Set CEngineProcedure vcx property to name of procedure files (WZENGINE, HTMLWIZ)
11. Create a folder called BMP in your projects folder. Copy BMP files "OPENTABL.BMP/MSK" and "NEWSORT.BMP/MSK" to that folder, and add those files to your project.
